---
title: Einrichtung
description: Wie Sie Ultracite in Ihrem Projekt installieren.
---

Ultracite kann mit allen gängigen Paketmanagern installiert werden. Sie benötigen Node.js v14.18+ (Node 18+ empfohlen) und ein Projekt mit einer `package.json`-Datei.

## Installation

Der einfachste Weg, um loszulegen, ist, das `init`-Skript von Ultracite auszuführen, das die notwendigen Pakete installiert und die Konfigurationsdatei für Sie einrichtet. Führen Sie in Ihrem Projektverzeichnis aus:

```package-install
npx ultracite init
```

Sie können optional die folgenden Flags an den `init`-Befehl übergeben:

| Flag                | Beschreibung                                     | Optionen                                                                 |
|---------------------|--------------------------------------------------|--------------------------------------------------------------------------|
| `--pm`              | Der zu verwendende Paketmanager.                  | `pnpm`, `bun`, `yarn`, `npm`                                             |
| `--frameworks`      | Die zu konfigurierenden Frameworks.               | Kommagetrennt: `react`, `next`, `solid`, `vue`, `qwik`, `angular`, `remix`, `svelte` |
| `--editors`         | Die zu konfigurierenden Editoren.                 | Kommagetrennt: `vscode`, `zed`                                           |
| `--agents`          | Die zu konfigurierenden KI-Agenten.               | Kommagetrennt: `vscode-copilot`, `cursor`, `windsurf`, `zed`, `claude`, `codex`, `kiro`, `cline`, `amp`, `aider`, `firebase-studio`, `open-hands`, `gemini-cli`, `junie`, `augmentcode`, `kilo-code`, `goose`, `roo-code`, `warp`, `droid` |
| `--hooks`           | Die Agent-Hooks, die konfiguriert werden sollen.  | Kommagetrennt: `cursor`, `claude`                                        |
| `--integrations`    | Zusätzliche Integrationen, die eingerichtet werden sollen. | Kommagetrennt: `husky`, `lefthook`, `lint-staged`                        |
| `--migrate`         | Zu entfernende Migrationstools.                   | Kommagetrennt: `eslint`, `prettier` (entfernt Abhängigkeiten, Konfigurationsdateien und Editor-Einstellungen) |
| `--skip-install`    | Das Installieren von Abhängigkeiten überspringen. | (kein Wert erforderlich)                                                  |
| `--quiet`           | Interaktive Eingabeaufforderungen und visuelle Ausgaben unterdrücken. | (kein Wert erforderlich, automatisch in CI aktiviert)                     |

### Programmatische Verwendung

Für Tools, die Ultracite programmgesteuert aufrufen müssen (z. B. Scaffolding-CLIs), können Sie das Flag `--quiet` verwenden, um alle interaktiven Eingabeaufforderungen und visuellen Ausgaben zu unterdrücken:

```bash title="Terminal"
npx ultracite init --quiet --pm npm
```

Das Flag `--quiet` wird automatisch aktiviert, wenn die Umgebungsvariable `CI` auf `true` oder `1` gesetzt ist, wodurch es sich für CI/CD-Pipelines eignet:

```bash title="Terminal"
CI=true npx ultracite init --pm npm
```

Im Quiet-Modus wird Ultracite:
- Alle interaktiven Eingabeaufforderungen überspringen
- Sinnvolle Standardwerte für alle Optionen verwenden
- ASCII-Art, Spinner und Protokollmeldungen unterdrücken
- Nur die zentrale Biome-Konfiguration erstellen
- Bei Erfolg sauber mit Code 0 beenden oder bei Fehler mit Code 1

## Erweiterungen

Wenn Sie Visual Studio Code verwenden, installieren Sie die offizielle [Biome](https://marketplace.visualstudio.com/items?itemName=biomejs.biome)-Erweiterung, die On-Save-Formatierung/-Korrektur ermöglicht:

```bash title="Terminal"
code --install-extension biomejs.biome
```

Zusätzlich wird, wenn Sie Tailwind CSS verwenden, empfohlen, die Erweiterung [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) für Klassen-Sortierung und Hinweise zu installieren:

```bash title="Terminal"
code --install-extension bradlc.vscode-tailwindcss
```